home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / eileen.arc / EILEEN.DOC next >
Encoding:
Text File  |  1986-08-11  |  8.6 KB  |  241 lines
  1.                                 EILEEN
  2.  
  3.                        User Registration Utility
  4.  
  5.  
  6.  
  7. (C) COPYRIGHT 1986 by System Enhancement Associates;
  8.     ALL RIGHTS RESERVED
  9.  
  10.  
  11.  
  12.                                 LICENSE                                LICENSE
  13.  
  14. Definitions:Definitions:
  15.  
  16.     ____    IFNA:     The International FidoNet Association, which can be
  17.               reached at FidoNet node 1/0, or by mail at:
  18.  
  19.               International FidoNet Association
  20.               PO Box 41143
  21.               St. Louis, MO. 63141
  22.  
  23.     _______    FidoNet:  A public amateur electronic mail network, whose members
  24.               are registered with IFNA in St. Louis.
  25.  
  26.     _______     ______  ______________    FidoBBS:  A public, not-for-profit bulletin board which is a
  27.               registered member of FidoNet, as shown by the most
  28.               recent node list published by IFNA in St.  Louis.
  29.  
  30.     _____    Sysop:    The person in charge of the maintenance and operation of
  31.               any given FidoBBS.
  32.  
  33. License:License:
  34.  
  35.     Each sysop of a registered noncommercial FidoBBS is hereby granted
  36.     a limited license to use EILEEN as follows:
  37.  
  38.                       ____    1) You may use it ONLY in conjunction with the operation and
  39.        maintenance of your FidoBBS.
  40.  
  41.     2) You accept full responsibility for whatever happens or fails to
  42.        happen.
  43.  
  44.                                                   ____    3) You may copy and distribute it freely, but ONLY to other sysops
  45.        of other FidoBBS systems.
  46.  
  47.     4) You may not charge a fee for copying and distributing it.
  48.  
  49.     5) You may not distribute copies which have been modified in any
  50.        way.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. Commercial users:Commercial users:
  62.  
  63.     Commercial use, distribution, and site licenses are available.
  64.     For more information, send FidoNet mail to node 107/8 or write to:
  65.  
  66.                      System Enhancement Associates
  67.                      21 New Street, Wayne NJ 07470
  68.  
  69. User support:User support:
  70.  
  71.     Your support is encouraged and appreciated.  User support is
  72.     voluntary for noncommercial systems.  You may not use these
  73.     programs in a commercial environment or in a governmental
  74.     organization without paying a license fee of $35 for each system
  75.     on which EILEEN will be used.  A program disk and printed manual
  76.     are available for $50.  All license fees received will be sent to
  77.     the International FidoNet Association.
  78.  
  79.  
  80.  
  81.                               DISCLAIMER                              DISCLAIMER
  82.  
  83. We accept no responsibility for anything at all.  You use this program
  84. at your own risk.  If they completely trash your system and destroy a
  85. multimillion dollar database, then you have our sincerest regrets, but
  86. you're on your own.
  87.  
  88.  
  89.  
  90.                              INTRODUCTION                             INTRODUCTION
  91.  
  92. EILEEN is based on the principle that the machine should do the work
  93. wherever possible.
  94.  
  95. We run our board as a semi-restricted system, where new callers get a
  96. reduced privilege level until they have answered the questionnaire.
  97. We found that the biggest nuisance in running such a system is
  98. processing the questionnaires.
  99.  
  100. We tried out the "French maids" written by Karl Schinke (107/16), but
  101. they didn't do quite what we wanted.  Finally exasperated beyond
  102. endurance, we wrote EILEEN.  (As a side note, if EILEEN doesn't do
  103. quite what you want, check out Karl's maids.)
  104.  
  105. EILEEN works on the idea of using your ANSWERS.BBS as your user
  106. database.  EILEEN sees it as consisting of one or more chunks of user
  107. data, where each chunk begins with a line that begins with an
  108. asterisk.  Obviously, she won't work right unless you have an asterisk
  109. command in your QUESTION.BBS before you get to the questions you care
  110. about.
  111.  
  112.  
  113.  
  114.                                OPERATION                               OPERATION
  115.  
  116. Using EILEEN is as simple as can be.  Just run her once a day as part
  117. of one of your external events.  She takes no arguments at this time.
  118.  
  119. EILEEN works in three passes:
  120.  
  121. ______Pass 1:  First EILEEN reads in your existing user list, as given in
  122.          the USER.BBS file.  If you have a very large number of users,
  123.          she may bomb out at this point.  The maximum number of users
  124.          EILEEN can handle depends on how much memory you have
  125.          available.
  126.  
  127.          EILEEN will show you the names of the users as she reads them
  128.          in.  The names will be displayed as follows:
  129.  
  130.               _______________     _____________       __________              Privilege level     Color display       Monochrome
  131.  
  132.               Sysop               Bright white        Bright white
  133.               Extra or Privel     Bright yellow       Bright white
  134.               Normal              Green               White
  135.               Disgraced           Blue                White
  136.               Twit                Red                 Underlined
  137.  
  138. ______Pass 2:  EILEEN will then read and process your ANSWERS.BBS file.  As
  139.          she works, she will display her progress in three columns.
  140.          EILEEN works by scanning through your current ANSWERS.BBS,
  141.          and copying the user data out to a file called ANSWERS.NEW.
  142.          When she's all done, she'll rename ANSWERS.BBS to
  143.          ANSWERS.BAK, and rename ANSWERS.NEW to ANSWERS.BBS.  The
  144.          general effect is that she creates a new ANSWERS.BBS, but
  145.          keeps the old one around for a day, just in case.
  146.  
  147.          As she reads a block of answers from ANSWERS.BBS, she
  148.          displays the user name in the first (left) column.  She
  149.          considers any line that begins with an asterisk to be the
  150.          start of current user data, and rather expects that it will
  151.          be formatted more or less the way Fido does it.
  152.  
  153.          If a line begins with a dash, then EILEEN assumes that it is
  154.          an outdated entry, and deletes it (see below).
  155.  
  156.          If EILEEN sees a block of answers for a user which is not
  157.          listed in USER.BBS, then she assumes that that user has
  158.          departed, and moves his answers to the end of a file named
  159.          ANSWERS.OLD (she'll create it if it doesn't already exist).
  160.          Any time she does this, she will display the name of the user
  161.          in the second (middle) column.
  162.  
  163.          If EILEEN sees more than one block of answers for a given
  164.          user, then she assumes that he has answered the questionnaire
  165.          again in order to update his user information, and she marks
  166.          the earlier sets of answers with a dash (see above) so she'll
  167.          know to throw them out next time.  Any time she does this,
  168.          she'll display the name of the user in the third (right)
  169.          column.
  170.  
  171. ______Pass 3:  Finally, EILEEN goes back through the USER.BBS file updating
  172.          users, making them either Normal or Disgraced, depending on
  173.          whether or not she saw a set of answers for them.  She will
  174.          only touch users who were either Normal or Disgraced.  She
  175.          will not "de-twit" someone, nor will she change users who are
  176.          privileged, extra privileged, or sysop.
  177.  
  178.          In those cases where she changes someones privilege level,
  179.          she will display their name in the third (right) column.  If
  180.          you have a color display, then the names will be displayed in
  181.          either green (if they were made Normal) or blue (if they were
  182.          made Disgraced).  Don't blink, because this list doesn't
  183.          generally hang around long.
  184.  
  185.  
  186.  
  187.                             TIPS AND NOTES                            TIPS AND NOTES
  188.  
  189. If we come up with any general advice, we'll add it here.  For now,
  190. about all we can think of to say is that you should probably take a
  191. look at the contents of ANSWERS.BBS every now and then.  EILEEN is
  192. pretty easy to fool.  All anybody really needs to do is to run through
  193. your questionnaire giving nonsense answers, and EILEEN will let them
  194. by.  We have a policy about that here:  They do it once, and they're a
  195. hacker.  They do it twice, and they're a Twit.
  196.  
  197.  
  198.  
  199.                              CAVEAT EMPTOR                             CAVEAT EMPTOR
  200.  
  201. EILEEN is provided "as is".  We wrote her with the sole purpose of
  202. providing a solution to our own needs and desires.  If you decide to
  203. hire her (or even if you don't), then you may from time to time have a
  204. problem or an idea or a suggestion as to how she might be improved.
  205. By all means, please keep it to yourself.  We already qualify for a
  206. "Fido utility target t-shirt" for enough things.
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.